home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / door / lotery40.zip / LOTTERY.DOC < prev    next >
Text File  |  1992-06-08  |  10KB  |  228 lines
  1.  
  2.                                  LOTTERY 4.0
  3.                                  ===========
  4.  
  5.                             A Livewire BBS Game Door
  6.                                PCBoard(TM) 14.5+ 
  7.  
  8.                                       By
  9.  
  10.                                 Richard Paquette
  11.                                    PO Box 416
  12.                               Mt. Laurel, NJ 08054
  13.  
  14.                                (C) Copyright 1990
  15.                                All Rights Reserved
  16.  
  17.                  Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS,
  18.                    Remote Access, SpitFire, WWIV plus others.
  19.  
  20.                  GAME DESCRIPTION!
  21.  
  22.     This is a quick and simple game that allows callers to play a game of 
  23. lottery for a prize that you configure. Simply set how many times you want a
  24. caller allowed in each day.. enter your registration number and then include
  25. a line with the prize for winners. That's it.. then they try a pick-3 or a
  26. pick-4 lottery game.. they can play as often as they want to once they are in
  27. the door, but remember that "YOU" decide how many times they can open the door.
  28.  
  29.         We have added couple more prizes so that callers can win when they 
  30. match either the first two or last two numbers in pick-3 and in pick-4 they
  31. can win with the first two, last two or middle two numbers. You decide the 
  32. prizes and be sure to list them correctly in the lottery.cfg file.
  33.  
  34.         In futue updates, we plan to add a pick-6 instant game along with a
  35. pick-9 weekly winner game, where the program will pick a ramdom number once a
  36. week and display to all entering the door who won for that week and what the
  37. prize was they won!
  38.  
  39.         The door creates a file called "intoday.dat", this file is to monitor
  40. how many times that caller entered the door today! You set in the config file
  41. how many times they are allowed in.
  42.  
  43.         If you delete this file, no record is kept and the caller will again be
  44. able to enter to door freely. PLEASE do not delete this file.
  45.  
  46.         IMPORTANT NOTE: There is now a feature where you can let a winner of 
  47. the Pick-3 or Pick-4 download a "Coupon" to redemm at your place of business.
  48. For example, you own a Pizza Parlor and want to give the winner a free pizza
  49. for the Pick-3 or Pick-4, then create with any ascii editor two files called,
  50. "coupon3.dat" and "coupon4.dat", YOU MUST LEAVE THE FIRST LINE AS IS in the
  51. example, we will write starting on Line 1, Column 17 the Ticket Number that is
  52. assigned to THAT WINNER! The rest of the file can be anything you want such as
  53. a discount coupon to be mailed in for access minus the value of the coupon or
  54. anything that you are willing to offer. NOTE: if you don't want to use this
  55. added feature, then rename or DELETE the coupon*.dat files. If they aren't
  56. there, the program will act as usual, if they are there, after winning, the
  57. door will take the winner to a download screen where they can download the
  58. coupon to be printed and redemmed at your place of business.
  59.  
  60.         The Ticket number is also written to the winner3.dat and winner4.dat
  61. files for you to compare when someone brings in a winning coupon!
  62.  
  63.         You can now charge time for each Pick-3 or Pick-4 attempt, if you put
  64. a 0 on the last line of the cfg, they will not be charged any time, if you
  65. decide to charge time to play the game and they win, the time is given back
  66. to them along with your prizes.
  67.  
  68.                                      ======= 
  69.  
  70.                                CONFIGURATION FILE
  71.  
  72. C:\PCB\PCBOARD.SYS                  <- Path/filename to PCBOARD.SYS
  73. The Livewire BBS                    <- Name of BBS
  74. Richard                             <- Sysop's first name
  75. Paquette                            <- Sysop's last Name
  76. 5                                   <- Times allowed in Door
  77. 999999                              <- Registration number (or some number)
  78. Six Month Patron Membership         <- Prize for the Pick-3 game (58 char max)
  79. Three Month Patron Membership       <- Small prize to match 2 numbers (53 max)
  80. One Year Patron Membership          <- Prize for the Pick-4 game (58 char max)
  81. Three Month Patron Membership       <- Small prize to match 2 numbers (53 max)
  82. 3                                   <- Time charged for each try in minutes
  83.  
  84. Please note that something must be on each line.. if you do not want to offer
  85. prizes for matching two numbers, simply put "No prize" without the quotes.
  86.  
  87.                                    =======
  88.  
  89.  IMPORTANT NOTE FOR NON STANDARD IRQ's:
  90.  
  91.                   Supports COM 1 to 4 on the standard IRQ's
  92.                     Com1/Com3 = IRQ4 and Com2/Com4 = IRQ3
  93.  
  94.                You can make use of the IRQ environment variable
  95.  
  96.     If you wish to use a non-standard IRQ, add the IRQ number after the 
  97.  configuration filename. For example the program is STORE and you want to use 
  98.  Com1 and IRQ5. The command line passed to your door would be:
  99.  
  100.                             STORE STORE.CFG /5 
  101.                                    or
  102.              STORE STORE.CFG /%IRQ% using the environment variable
  103.  
  104.     The /5 tells STORE to use IRQ5 rather than the standard IRQ4 that is
  105.  normally used with COM1. No /x parameter is needed for the standard IRQ's.
  106.  
  107.                               LOTTERY BATCH FILE
  108.  
  109.  This is the batch file whose name is entered in PCBSETUP. It should reside in
  110.  your default PCB directory. Leave this as is except for changing the paths.
  111.  
  112.  ECHO OFF
  113.  E:
  114.  CD\LOTTERY
  115.  LOTTERY LOTTERY.CFG  <--- Please read NOTE below
  116.  C:
  117.  CD\PCB
  118.  BOARD
  119.  
  120.    NOTE: Lottery requires the presence of BRT71EFR.EXE either in the
  121.          same directory as Lottery or accessible via PATH. If you set
  122.          your library in autoexec.bat and all the brun files there,
  123.          then you have no problems.. 
  124.  
  125.      SET MYLIB = C:\MYLIB
  126.  
  127.      Be sure to put all your brun*.exe files in the mylib directory!
  128.  
  129.          We are able to read PCBoard variables for path and directory or
  130.  you can set your own, for example in the batch file:
  131.  
  132.          c:\
  133.          cd\lottery
  134.          set pcbdrive=c: or whatever your "root" directory is like maybe d:
  135.          set pcbdir=\pcb or whatever your "home" directory is like maybe (cat)
  136.          lottery lottery.cfg
  137.          c:\
  138.          cd\pcb
  139.          board
  140.  
  141.          Then your first line in the cfg file would look like this:
  142.  
  143.            %PCBDRIVE%%PCBDIR%\users.sys  <-- or whatever your system is
  144.  
  145.                      ------------------------------------
  146.  
  147.                                 DOOR OPERATION
  148.                                 --------------
  149.   
  150.   F3    -   Toggles the printer On/Off.
  151.             Value is passed to PCBoard.
  152.   F4    -   Toggles the Page Bell On/Off.
  153.             Value is passed to PCBoard.
  154.   F5    -   DOS Shell.  Allows SysOp to exit to DOS from inside a DOOR.
  155.   F7    -   Toggles the Caller Alarm On/Off.
  156.             Value is passed to PCBoard.
  157.   F8    -   Returns the caller involuntarily to PCBoard.
  158.             Without letting them know that the sysop called them back!
  159.   F9    -   Toggles the local display On/Off.
  160.             Value is passed to PCBoard.
  161.   F10   -   Activates SysOp CHAT mode within the DOOR.
  162.   ESC   -   Deactivates CHAT mode.  DOOR is resumed.
  163.   HOME  -   HELP key for status line options.
  164.   UP    -   Allows the SysOp to temporarily give the caller extra time
  165.             while in the DOOR.  This time is NOT passed to PCBoard.
  166.   DN    -   Allows the SysOp to temporarily subtract time from the
  167.             caller while in the DOOR.  This time is NOT passed to PCBoard.
  168.   ALT-N -   SysOp next on toggle.
  169.             Value is passed to PCBoard.
  170.   ALT-X -   PCBoard will exit after current caller logs off.
  171.             Value is passed to PCBoard.
  172.  
  173.                             WATCHDOG/CTTY/ANSI.SYS
  174.                             ----------------------
  175.  
  176.         CTTY and WATCHDOG are not required and should not be used with
  177.         this program.  LOTTERY contains its own communication routines
  178.         which monitor the COM port.  If carrier is lost, it will return
  179.         to PCBoard where the BBS will log the user off the system.
  180.         ANSI.SYS, or something similar, is required for LOTTERY to
  181.         function properly!
  182.  
  183.  
  184.                                  DISTRIBUTION
  185.                                  ------------
  186.  
  187.         LOTTERY is COPYRIGHTED by Richard Paquette, with all rights reserved.
  188.         This program is being distributed via the SHAREWARE concept and as
  189.         such, may be copied freely with the following restrictions:
  190.  
  191.                 * The program must be supplied in it's original
  192.                   unmodified form, including documentation.
  193.  
  194.                 * LOTTERY may not be distributed as part of any
  195.                   commercial application or service without the
  196.                   express, written consent of the author.
  197.  
  198.                 * Vendors of Shareware/Public Domain software may
  199.                   not distribute this program without the express,
  200.                   written consent of the author.
  201.  
  202.                                  REGISTRATION
  203.                                  ------------
  204.  
  205.         LOTTERY represents many hours of programming and the author
  206.         deserves just compensation for his time, efforts and expertise.
  207.         If you find this program to be of some value and you continue
  208.         to use it on your BBS system, you must return the registration
  209.         form provided along with the registration fee. Registration
  210.         entitles you to free upgrades via modem from The Livewire's Support
  211.         Conference for a period of one year. Payments should be made in
  212.         the form of a check or money order (do NOT send cash!). Foreign
  213.         orders must be in U.S. funds drawn on a U.S. bank. You may also call
  214.         The Livewire BBS and register online via Visa or Mastercard by
  215.         typing  REGISTER  from the Main Board.
  216.  
  217.         Suggestions and/or comments may be sent to the address below or
  218.         via electronic mail: 
  219.  
  220.                   HUBSNJ for RelayNet and Node ID is: LIVEWIRE
  221.  
  222.                                  Richard Paquette
  223.                                  The Livewire BBS     
  224.  
  225.           Public Free Access Node: (609) 235-5297 MNP/5 - 300/1200/2400
  226.                Access to all other nodes after registering a door.
  227.                             ----------------------
  228.